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SPECIFICATION 



Title of Invention 



PROGRAMMABLE AGENT WORKSTATION SYSTEM AND METHOD 



Partial Waiver of Copyright 



All of the material in this patent application is 
subject to copyright protection under the copyright laws of 
the United States and of other countries. As of the first 
effective filing date of the present application, this 
material is protected as unpublished material. 

However, permission to copy this material is hereby 
granted to the extent that the copyright owner has no 
objection to the facsimile reproduction by anyone of the 
patent documentation or patent disclosure, as it appears in 
the United States Patent and Trademark Office patent file or 
records, but otherwise reserves all copyright rights 
whatsoever . 



Cross Reference to Related Applications 



Not Applicable 
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Statement Regarding Federally Sponsored Research 

or Development 

Not Applicable 

Reference to a Microfiche Appendix 

Not Applicable 

Field of the Invention 

The invention is related in the general area of network 
call centers and programmable agent workstations. 

Background of the Invention 

Overview 

The present invention discloses a programmable 
workstation system and method for network based call center 
with telephony functions provided over the IP network and 
using a personal computer. For such call center, there is a 
need to coordinate the telephony functions with agent 
availability functions. Existing solutions use a switch and 
PSTN phone to communicate information to an automated call 
director (ACD) . There is a need to solve the problem of 
doing similar reporting and with coexistence of telephony 
functions along with agent data functions. Features of 
invention include (a) special protocols to relay agent 
information to Virtual ACD and coexist with H.323 signaling 
and (b) the ability to relay agent status and provide screen 
based interface to agent also for such information for agent 
availability and alerting. 
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General System Architecture 



The general system architecture of the present 

invention is illustrated in FIG. 1, with the agent 

workstation (1121) being the focus of the present invention 
teachings - 



Existing solutions to the problem solved by the present 
invention use a switch and PSTN phone to communicate 
information to an automated call director (ACD) . However, 
there have been recent efforts to integrate these functions. 
See Nicholas Cravotta, "Voice Over Packet - Putting it all 
Together", ELECTRONIC DESIGN MAGAZINE, pages 107-118 (March 
16, 2000) . 

Referencing FIG. 1, the present state of the art 
includes telephone equipment (1101) , public switched 
telephone networks (1102) , and public branch exchanges 
(1103) . Remaining elements in this figure may be 

incorporated using the teachings of the present invention to. 
provide features not present in the prior art. 



Accordingly, the objects of the present invention are 
(among others) to circumvent the deficiencies in the prior 
art and affect one or more of the following objectives: 

1. Integration of VoIP into a Directory Assistance System 
(DAS) operator position, allowing the operator to 
either manually (through key presses) or 
programmatically (through macro command invocations) to 
control voice-related parameters (such as microphone 
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level and headset level) and call-related parameters' 
(sign on, audio release, position release, not ready) . 

2. Ability for one or more DLL applications, running on 
the Intelligent Workstation Platform (IWSP), to open 
from 1-8 client TCP/IP socket connections to other 
applications, running either on the same PC or 
elsewhere in the network. The PlusTapi (109, 5500) 
application was one such DLL. The PlusTcp DLL (109, 
5500) that provided this support, generated advisements 
back to any of the other IWSP DLLs when data was 
received. The PlusTcp DLL (109, 5500) also returned 
error codes to the owing DLL whenever a TCP/IP 
exception occurred. The owning DLL could subsequently 
call a PlusTcp API that would return a string that 
contained a textual message for the corresponding error 
code. The textual message would be generated in 
whatever language (English, Spanish, etc.) was 
currently selected on the position, which would be 
subsequently displayed to the operator. 

3. Invocation of macros through events being generated 
from the PlusTapi- JavaPhone interface. Macros were 
used for updating screen displays or performing other 
operations defined to the IWSP workstation. PlusTapi 
macro invocations allow the user to generate flexible 
displays, informing the operator of the various events 
(call arrival, call termination, headset volume 
adjustments, etc.). PlusTapi macro commands also, 
allowed the user to invoke various controls in the 
JavaPhone (e.g., make ready/not ready, audio release, 
etc . ) . 

4. PlusTapi included a TCP/IP "ping" macro command that 
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would, with a single key press or programmatically 
through the DDE protocol or the IWSP DLL API, issue a 
ping request through the JavaPhone application (105, 
4400) to the Call Director (103, 1110) and then display 
the results back to the operator in a Windows™ 
Messagebox. 

5. PlusTapi (109, 5500) supports two modes of operation - 
one in which macro command failures would generate 
message box displays to the operator, and one in which 
macro command failures would generate return codes to 
the invoking application. The mode that PlusTapi 
operates in is controlled through a macro command and 
can be dynamically changed as required. 

While these objectives should not be understood to 
limit the teachings of the present invention, in general 
these objectives are achieved by the disclosed invention 
that is discussed in the following sections. 

Brief Summary of the Invention 

Overview 

The invention is related in the general area of a 
programmable workstation for network based call center with 
telephony functions provided over the IP network and using a 
personal computer. For such call center, there was a need 
to coordinate the telephony functions with agent 
availability functions. Existing solutions use a switch and 
PSTN phone to communicate information to an ACD. We need to 
solve the problem of doing similar reporting and do 
coexistence of telephony functions along with agent data 
functions. Features of invention (1) Special protocol to 
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relay agent information to Virtual ACD and coexist with 
H.323 signaling (2) Ability to relay agent status and' 
provide screen based interface to agent also for such 
information for agent availability and alerting. 



IP based agent technology is evolving for IP call 
centers. The major problems with legacy call centers have 
been proprietary interfaces for service creation within 
switches that are complex to change. Most switch vendors 
10 control what information is accessible and makes development 
of new services very difficult. 



Referencing FIG. 2, the present invention when 
incorporated into a system environment (2200) enables a 
virtual ACD environment (2203) with integrated Voice 



15 response unit (VRU) and Virtual Automatic Call Distributor 
(VACD) (1114) to have a programmable interface (1121) with a 
common script logic so that the complete call flow can be 
executed in a single process. The operator interface (1122) 
may take a variety of forms. 



The file of this patent contains at least one 
drawing/photograph executed in color. Copies of this patent 
with color drawings/photographs is provided by the Patent 
and Trademark Office upon request and payment of the 
25 necessary fee. 

For a fuller understanding of the advantages provided 
by the invention, reference should be made to the following 



5 



Generalized System Architecture 



20 



Brief Description of the Drawings 
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detailed description together with the accompanying drawings 
wherein : 

FIG. 1 illustrates an exemplary system application 
environment of the present invention; 

FIG. 2 illustrates an exemplary data flow architecture 
diagram supporting the present invention teachings; 

FIG. 3 illustrates a generalized system block diagram, 
showing major components of the present invention; 

FIG. 4 illustrates an exemplary JavaPhone API interface 
used in some embodiments of the present invention; 

FIG. 5 illustrates an exemplary PlusTCP API interface 
used in some embodiments of the present invention; 

FIG. 6 illustrates an exemplary PlusTapi API interface 
used in some embodiments of the present invention; 

FIG. 7 illustrates an exemplary normal sign on message 
sequence data flow used in some embodiments of the present 
invention; 

FIG. 8 illustrates an exemplary normal sign off message- 
sequence data flow used in some embodiments of the present 
invention; 

FIG. 9 illustrates an exemplary headset unjack logoff 
message sequence data flow used in some embodiments of the 
present invention; 

FIG. 10 illustrates an exemplary inbound call message 
sequence data flow used in some embodiments of the present 
invention; 
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FIG. 11 illustrates an exemplary dial number dialog 
used in some embodiments of the present invention; 

FIG. 12 illustrates an exemplary outbound message 
sequence data flow used in some embodiments of the present 
invention; 

FIG. 13 illustrates an exemplary call hold/unhold 
message sequence data flow used in some embodiments of the 
present invention; 

FIG. 14 illustrates an exemplary call transfer to 
outside number message sequence data flow used in some 
embodiments of the present invention; 

FIG. 15 illustrates an exemplary call conference with 
supervisor message sequence data flow used in some 
embodiments of the present invention; 

FIG. 16 illustrates an exemplary operator hangup with 
disconnect call key message sequence data flow used in some 
embodiments of the present invention; 

FIG. 17 illustrates an exemplary PlusTapi utility mode 
panel used in some embodiments of the present invention; 

FIG. 18 illustrates an exemplary InfoWin utility 
settings for CSW used in some embodiments of the present 
invention; 

FIG. 19 illustrates an exemplary CSW running in normal 
mode used in some embodiments of the present invention; 

FIG. 20 illustrates an exemplary data flow illustrating 
how the present invention may be used to access multiple 
remote communication systems. 
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Description of the Presently Preferred Exemplary 

Embodiments 

Embodiments are Exemplary 

While this invention is susceptible of embodiment in 
5 many different forms, there is shown in the drawings and 
will herein be described in detailed preferred embodiment of 
the invention with the understanding that the present, 
disclosure is to be considered as an exemplification of the 
principles of the invention and is not intended to limit the 
10 broad aspect of the invention to the embodiment illustrated. 

The numerous innovative teachings of the present 
application is described with particular reference to the 
presently preferred embodiments, wherein these innovative 
teachings are advantageously applied to the particular 

15 problems of a programmable agent workstation system and 
method. However, it should be understood that these 
embodiments are only examples of the many advantageous uses 
of the innovative teachings herein. In general, statements 
made in the specification of the present application do not 

20 necessarily limit any of the various claimed inventions. 
Moreover, some statements may apply to some inventive 
features but not to others. In general, unless otherwise 
indicated, singular elements may be in the plural and visa 
versa with no loss of generality. 

25 Definitions 

Throughout the discussion in this document the 
following definitions is utilized: 
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System Blocks / Procedural Steps Not Limitive 



The present invention may be aptly described in terms 
exemplary system block diagrams and procedural 



flowcharts. While these items are sufficient to instruct 
5 one of ordinary skill in the art the teachings of the 
present invention, they should not be strictly construed as 
limiting the scope of the present invention. One skilled in 
the art is aware that system block diagrams may be combined 
and rearranged with no loss of generality, and procedural 
10 steps may be added or subtracted, and rearranged in order to 
achieve the same effect with no loss of teaching generality. 
Thus, it should be understood that the present invention as 



depicted in the attached exemplary system block diagrams and 
procedural flowcharts is for teaching purposes only and may 



15 be reworked by one skilled in the art depending on the 
intended target application. 



provided that utilize personal computer (PC) technologies to 
20 illustrate the teachings of the present invention. The term 
^personal computer' should be given a broad meaning in this 
regard, as in general any computing device may be utilized 
to implement the teachings of the present invention, and the 
scope of the invention is not limited just to personal 
25 computer applications. 

Operating System Not Limitive 

Additionally, while the present invention may be 
implemented to advantage using a variety of Microsoft® 
operating systems (including a variety of Windows™ 
30 variants), nothing should be construed to limit the scope of 



Personal Computer fltof Ljwtiye 



ru 



Throughout the discussion herein there is examples 
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the invention to these particular software components. In 
particular, the system and method as taught herein may be 
widely implemented in a variety of systems, some of which 
may incorporate a graphical user interface. 



System 



w 



53 3 

= y 



Overview 



The present invention generally can be viewed in terms 
of the exemplary system architecture illustrated in FIG. 3.' 
This exemplary architecture will now be described in detail. 

10 The following discussion details the functional 

specification and other elements necessary for Directory 
Assistance (DAS) workstations to support a proposed Network 
Call Center. FIG. 3 illustrates a high-level representation 
of the proposed system architecture. There are several 

15 enhancements to the Directory Assistance System environment 
in the proposed Network Call Center, including: 

1. The transmission of voice data over the TCP/IP network 
instead of dedicated audio lines. 

2. Usage of a standard PC with a serial-port attached 
20 headset unit for the audio signals. 

3. Elimination of the usual call center switch and the 
Call Processing Gateway Workstation Functional 
Specifications for the Network Call Center. 

All of the switch related controls, such as "make 
25 busy", along with the audio signal, is sent over the TCP/IP 
network to the "JavaPhone" application (105, 4400) residing 
on the workstation. The workstation generally provides a 
panel that contains visual indicators to the operator of the 
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current call and audio states. This panel is referred to in 
this document as the "Call Status Window" (CSW) . 

Assumptions 

The following design points and assumptions have been 
identified for the DISP/IWSP workstation: 

1. TPORT continues to support all existing messaging 
between the workstation and the existing components in 
the DAS network (e.g., LSIP, MAP, etc.). 

2. All of the Call Control messages (call arrival, 
disconnect, etc.) are sent and received through the 
JavaPhone API. The Call Processing Gateway (CPG) are 
not be utilized. 

3. Voice may be transmitted to the workstation using 
"Voice Over Data" (VoD) technology. 

4. The "JavaPhone" provides the audio support within the 
workstation, utilizing the ShelCad external component 
(attached to the PC via the serial port) . 

5. Supervisor monitoring of an operator may not include 
the capability to listen to the operator's audio 
signal . 

6. The workstation must include support for any audio- 
related controls (e.g., Volume Up/Down, Microphone 
Mute, etc. ) . 

7. The workstation provides new support for all switch- 
related messaging to the newly developed "Call 
Director" component (e.g., Make Busy, etc.). 



8. The workstation must provide some sort of "switch and 
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audio state display" to the operator containing 
information such as call status, muted microphone, 
position made busy, etc. 

9. Basic DA functionality in the DISP/IWSP workstation is 
supported. 

10. Voice Store and Forward and Speech Recognition 
technology is not included. 

11. The workstation runs as a 16-bit application on the 
Windows™ 95 platform, but is not limited to this' 
application . 

Exemplary Workstation Design 

The following sections describe the implementations for 
each of the identified features required for the Network 
Call Center. The workstation may continue to be implemented 
as a 16-bit Windows™ application but can also execute in a 
Windows™ 95 environment. Additional workstation components 
is required for the new features. FIG. 3 illustrates a 
sample pictorial representation of the exemplary DA 
workstation software components. 

The new components are shown in FIG. 3 with bold lines, 
and bold blue lettering and include: 

1. JavaPhone Application (105, 4400); 

2. "PlusTcp DLL" (109, 5500); and 

3. "PlusTapi DLL" (110, 6600). 

The existing components that will require modifications 
are shown in bold lines with normal black lettering and 
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include a DISP DLL (Directory Assistance client 
application) . The following sections will describe each of 
these discrete components as well as identify other 
implementation requirements for the Network Call Center. 

JavaPhone Application (FIG. 4) (105. 44001 

The JavaPhone application (105, 4400) as illustrated in 
FIG . 3 (105) and FIG. 4 (4400) provides two basic functions: 

1. audio controls and status (4411); and 

2. call controls and status (4412). 

The JavaPhone application (105, 4400) supports a local 
TCP/IP socket interface that will allow the workstation 
software (DISP/IWSP) to perform the various operations 
available and to receive any status events or attributes. A 
single local TCP/IP socket is used for communicating both, 
audio and call controls . 

JavaPhone Audio Controls (4401) 

The audio path will involve sending "Voice over Data" 
(VoD) using the H.323 protocol. The operator will utilize a 
headset that is connected either to the ShelCad product 
(external to the PC hardware) . The JavaPhone application 
(105, 4400) will transmit and receive the audio data through 
a TCP/IP socket connection to the "VoD Gateway". 

The following audio features may be implemented in this 
functional block: 

1. Volume Up/Down controls (4421); 

2. Microphone Mute/Unmute controls (4422); 
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3. Raise/Lower Microphone gain controls (4423); and 

4. Detection of headset unjacking (4424). 

JavaPhone Call Controls (4412) 

The call controls is transmitted and received between 
5 the JavaPhone application (105, 4400) and the Call Director 
using the Java Telephony API (JTAPI) . The following call 
controls and status events are generally available in the. 
present invention: 

1. Sign On/Sign Off controls and status events (4425); 
10 2. Call arrival indications (4426); 

3. Call termination indications (4427); 

4. Call Conferencing (4428); 

5. Make Busy control (4429); and 

6. Hold/Unhold call control (4420). 

15 The TCP/IP messaging API provides all of the audio and 

call controls sent across the local socket connection. 



PIusTcd DLL (FIG. 5) M09. 5500) 

The PlusTcp DLL (109, 5500) will receive data into the 
buffers provided by the calling application (in this case, 
20 the PlusTapi DLL (110, 6600)). Consequently, there is no 
need for the PlusTcp DLL (109, 5500) to internally buffer 
messages received from any of the open sockets. 
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As illustrated in FIG. 5, this new IWSP DLL provide the 
following commands: 

TcpOpen (5521) - this command will establish the socket 
connection with the TCP/IP address and port number 
provided. 

TcpClose (5522) - this command will terminate the 
socket connection 

TcpSend (5523) - this command will send data over the 
previously established socket connection. 

TcpRecv (5524) - this command will receive data from 
the previously established socket connection. 

TcpGetLastError (5525) - this command will retrieve the 
most recent error for the requested conversation (i.e. 
- socket) . 

TcpGetErrorString (5526) - this command will return a 
message string that contains the textual description of 
the error return code obtained through the 
TcpGetLastError command. 

The above commands support the basic TCP/IP messaging 
needed for any IWSP DLL communicating with another 
application residing either on the same PC (as in the case 
of the JavaPhone application) or elsewhere in the TCP/IP 
network. Each command specifies a "conversation" number 
25 that the PlusTcp DLL (109, 5500) can send and receive data 
on the proper socket. 

The PlusTcp DLL (109, 5500) supports an advisement 
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scheme that is used for notifying the associated client (in 
this case, the PlusTapi DLL (110, 6600)) that data is 
available. The using IWSP DLL enumerates a non-persistent 
variable that is used for invoking a callback routine 
5 whenever data is received on an open socket. This non- 
persistent enumerated variable must be declared to the IWSP 
platform and then specified as a parameter in the TcpOpen 
command (see below) . When the PlusTcp DLL (109, 5500) is 
notified through the WINSOCK DLL API that data is available 
10 on an open socket, the PlusTcp DLL (109, 5500) will invoke 
the IWSP's PlusPokeQata command, specifying the enumerated 
□ non-persistent variable provided on the TcpOpen command. 

The IWSP platform will then detect that the enumerated 
%f variable is non-persistent and invoke the specified callback 

15 routine (in this case, the routine in the PlusTapi DLL (110, 
£n 6600)). The owning DLL (i.e. -PlusTapi) should then pust 

itself a Windows™ "WMJJSER" message to indicate to itself 
C3 that it needs to read from the socket. It should not 

fl] perform the TCP/IP receive on the same thread of execution 

ru 20 of the callback routine. When the owning DLL later receives 
S its WM USER message, it must then invoke the TcpRecv command 

(enumerated by the PlusTcp DLL) to read the data from the 
TCP/IP socket. Note that due to the nature of the TCP/IP 
socket data stream, a single TcpRecv operation can return 
25 more than one message from the JavaPhone application. 

The PlusTcp DLL (109, 5500) is designed to support up 
to eight (8) socket connections for usage by one or more 
IWSP DLLs. Each session is identified with a "conversation 
number" that is specified as the first parameter in each of 
30 the PlusTcp DLL (109, 5500) enumerated commands. The 
PlusTcp DLL (109, 5500) maintains and enumerate to IWSP the 
internal variables containing any errors received during the 
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last TCP/IP API call, thereby allowing the client 
applications to obtain this information. 

TcpOpen Command (5521) 

This command is invoked whenever an IWSP DLL wishes to. 
open a TCP/IP socket to another application that is acting 
as a TCP/IP server. An advisement variable is specified in 
the parameter list that would be subsequently invoked 
whenever data is received on the socket. 



Format : 


TcpOpen (nConv, slnetAddress, nPortNumber, 
sAdviseVar ) 


Parameters : 


Nconv 


"Conversation number". 
The PlusTcp DLL supports 
up to 8 different 
sessions. Each session 
can have one active 
socket. Valid values are 
1-8. 




slnetAddress 


TCP/IP address of the 
server system (e.g., 
9.83.85.218 or "LocalHost 1 




nPortNumber 


Port number of the server 
system (e. g. - 23) 




sAdviseVar 


This should be a "non- 
persistent" enumerated 
variable declared to IWSP. 
The callback routine 
specified in this 
enumerated variable is 
called whenever data is 
received on the active 
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socket . 


Returns : 


PLUS_COMMAND_OK 


Socket opened successfully 




PLUS_COMMAND 


PlusTcp DLL not installed. 




NOT_AVAIL 






PLU S_COMMAN D__ERROR 


General failure occurred. 




-100 


Invalid parameters passed. 




-101 


Invalid conversation 
number. 




-102 


Requested conversation 
number already in use. 



TcpClose Command (5522) 

This command is invoked whenever an IWSP DLL wishes to 
close a previously opened TCP/IP connection. 



Format : 


TcpClose (nConv) 


Parameters : 


Nconv 


"Conversation number" , 
previously initialized 
with an invocation of the 
TcpOpen command. 


Returns : 


PLUS_COMMAND_OK 


Socket successfully 
closed. 




PLUS_COMMAND_ 
NOT_AVAIL 


PlusTcp DLL not 
installed. 




PLUS_COMMANDJERROR 


General failure occurred. 
The IWSP DLL should 
invoke the 

TcpGetLastError command 
to obtain the TCP/IP 



BOC9-1999-0054-US1 Page 22 



EXPRESS MAIL LABEl^B EL470371049US 



failure indication . 



TcpSend Command (5523) 



This command is invoked whenever an IWSP DLL wishes to 
write data to a TCP/IP socket previously established with 
the TcpQpen command. 



Format : 


TcpSend (nConv, sDataName, nOf set , nLength) 


Parameters : 


Nconv 


"Conversation number " . 
previously initialized with 
an-invocation of the T en 
command. 




SDataName 


Enumerated variable name 
that contains the data to be 
written to the socket. 




Noffset 


Offset into the sDataName 
buffer that the data is to 
be written from. 




Nlength 


Length of the data to be ■ 
written. 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 




PLUS_COMMAND_ 


PlusTcp DLL not installed. 




NOT_AVAIL 






PLU S_COMMAN D_ERROR 


General failure occurred. 
The IWSP DLL should invoke 
the TcpGetLastError command 
to obtain the TCP/IP failure 
indication . 
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TcpRecv Command (5524) 

This command is invoked whenever an IWSP DLL wishes to 
read data from a TCP/IP socket previously established with 
the Tcpppen command. Note that TCP/IP data is received as a 
5 data stream, which implies that the buffer could contain 
more than one application message in it. It is the 
responsibility of the receiving application to parse through 
the data, decoding its contents. 



Note: This command does not block on the read of the 
10 TCP/IP socket. If no data is available, it will return 
immediately to the caller with a return code of 0. 



xs.': 5 


Format : 


TcpRecv (nConv, sDataName, nOffset, nLength) 




Parameters : 


Nconv 


initialized with an 








invocation of the Tcpppen 








command. 


: 5r 




SDataName 


Enumerated variable name 
that is to contain the data 


pzz 

\sj 






read from the socket. 


hJ 




Nof fset 


Offset into the sDataName 
buffer that the data is to 
be read into. 






Nlength 


Maximum length of the data 
to be read. 




Returns : 


0 


No data available. 






> 0 


Length of data read from 
socket . 






PLUS_COMMAND_ 


PlusTcp DLL not installed. 






NOT_AVAIL 
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ocIlcJLclX IallUIc OCCUrretJ. . 






The IWSP DLL should invoke 






the TcpGetLastError command 






to obtain the TCP/IP failure 






indication. 



TcpGetLastError Command (5525) 



This command is invoked whenever an IWSP DLL wishes to 
obtain the specific error indication that occurred during 
the invocation of one of the other available PlusTcp DLL 
5 (109, 5500) commands (see above) . 



yg 


Format : 


TcpGetLastError (nConv sDataName) 


%i 


Parameters : 


NConv 


"Conversation 


l~J : 






number" , previously 


CP 






initialized with an 


s 






invocation of the TcpOpen 


f'l 

m 






command. 


= fc? 




SDataName 


Enumerated variable name 








that is loaded with the last 








TCP/IP return code. This 
variable should be an 
unsigned short data type. 




Returns : 


PLUS_C0MMAND_0K 


Command executed 
successfully. 






PLUS_COMMAND_ 


PlusTcp DLL not installed. 






N0T_AVAIL 








PLUS_COMMAND_ERROR 


General failure occurred. 



TcpGetError String (5526) 

This command will return a message string that contains 
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the textual description corresponding to the error return 
code obtained through the TcpGetLastError command. 





Format : 


TcpGetErrorString (nErrNum, sDataName , nMaxBy tes ) 




Parameters : 


NerrNum 


Error number returned through 
usage of the TcpGetLastErr 

command. 






SdataName 


Data item name that is loaded 
with the string corresponding 
to the nErrNum parameter 


h\\ 
CP 




NmaxBytes 


Maximum number of bytes, 

terminator, that are to be 
copied into the sDataName 
variable . 


5 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 


y : 




PLUS_COMMAND_ 


PlusTcp DLL not installed. 


— ^ 
: : 




NOT_AVAIL 








P L U S_C OMMAN D_E RRO R 


General failure occurred. 






-103 


Invalid Error number. 



Error Handling 



The PlusTcp DLL (109, 5500) will always return a 
5 negative numeric ( PLUS_COMMAND_ERROR) return code through 
the IWSP DLL API whenever one of its calls to the Winsock 
API produces an error. This will allow the calling DLL (in 
this case, PlusTapi) to choose to deal with the error either 
programmatically or by generating an error message to the 
10 operator. When an error with the Winsock API is detected 
during the handling of a TcpSend, TcpRecv, or TcpClose 
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command, PlusTcp will store the return code of the specific 
failure in its internal variable accessible through the 
TcpGetLastError command. The calling DLL will receive only 
the P L U S_C OMMAN D_E RROR return code through the IWSP DLL API. 
It should then perform the TcpGetLastError command, 
specifying the appropriate conversation number, to obtain 
the specific error code. The calling DLL can then 
optionally call the TcpGetErrorString to obtain an error' 
message string (from the currently selected language file) 
that matches the error number obtained through the 
TcpGetLastError call . Since the PlusTcp enumerates a 
message string for each of the possible error conditions, 
the calling DLLs do not need to enumerate equivalent 
strings. The customer can alter the textual content of 
these strings through usage of the IWSP Define Language 
utility. Note that the TcpOpen command does return more 
specific return codes since these failures would be 
occurring before a TCP/IP conversation could be established 
with the Winsock DLL. 

If an unexpected TCP/IP error occurs which results in 
the termination of an active session, the PlusTcp DLL (109/ 
5500) will not attempt to perform any retries to reestablish 
the session. Subsequent command invocations on the affected 
conversation (socket) will generate error status in 
response. The calling DLL can then report the error through 
the man-machine interface. 



The PlusTapi DLL enumerates the commands and data items 
to the IWSP platform that will allow a DA operator to 
communicate with the JavaPhone application (105, 4400) and 
perform the related audio and call control operations. The 



PflysTaoo DLL (FIG. 6) (110. 6600]) 
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PlusTapi DLL (110, 6600) enumerated commands support usage 
of IWSP Softkeys or DISP Macro Keys for invoking the 
operations that will perform the required messaging to the 
JavaPhone application. The PlusTapi DLL (110, 6600) utilize 
5 the PlusTcp DLL (109, 5500) to send and receive the TCP/IP 
messaging to and from the JavaPhone application. 

The PlusTapi DLL (110, 6600) also provides visual 
status indicators to the operator (such as for Microphone 
Muted) . This is accomplished through textual displays on 
10 the existing "InfoWin DLL". 

The PlusTapi DLL (110, 6600) utilizes the PlusTcp DLL 
(109, 5500) command (TcpOpen) to establish a local socket 
connection to the JavaPhone application (105, 4400) during 
startup. Retry logic is ' provided to handle any startup 
15 synchronization of the two applications. 

The PlusTapi interface with the JavaPhone application 
(105, 4400) is handled independently from the existing DISP- 
CPG interface. All messaging related to call processing is 
sent and received through the JavaPhone API. When the 

20 PlusTapi DLL (110, 6600) receives an indication of a call 
arrival from the JavaPhone, it will instruct DISP to 
simulate a start of call by invoking the PosNewCall command. 
Similarly, when the PlusTapi DLL (110, 6600) receives from 
the JavaPhone the indication that the call has terminated, 

25 it will instruct DISP to simulate an end of call by invoking 
the PosCallRelease command. These commands will allow DISP 
to track rudimentary operator statistics. Call completion is 
offered, which is accomplished by performing a "blind 
conference" operation through the JavaPhone API. When the 

30 call completion operation is successful, the Call Director 
is instructed to remove the call from the operator position. 
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At that point, the JavaPhone, and subsequently PlusTapi, 
will receive a CallRemoved message. PlusTapi would perform 
the appropriate advisement on the "macro event", allowing 
for the update of the Call Status Window. 

5 With each message that PlusTapi sends to the JavaPhone 

application, it will receive a corresponding response 
indicating the success or failure of the request. These 
responses are directly generated by the component that is 
actually performing the requested operation. For example, 

10 if PlusTapi sends the AgentNotReady message to the JavaPhone 
application, the request will flow up to the "Call Director 
Custom Server" and then to the "Virtual ACD" before 
returning back down to the JavaPhone application (105, 4400) 
and then onto PlusTapi. When the response is received, 

15 PlusTapi will trigger any events that are associated with 
the request. In the "agent not ready" example, the 
"TapiEventNotReady" macro advisement event would be 
triggered, most likely resulting in textual display change 
on the InfoWin DLL for the operator's visual confirmation of 

20 the request. The fact that responses are directly generated 
by the owning system component will guarantee that the 
visual display to the operator accurately reflects the 
resulting success or failure of the request (as opposed to 
JavaPhone generating immediate successful responses 

25 indicating that the request has only been forwarded on to 
the appropriate system component) . 

PlusTapi will receive a CallCreated message and a 
CallRemoved message with each call received at the 
workstation. This will apply regardless of how the call was 
30 initiated or terminated. 

The PlusTapi DLL (110, 6600) enumerates all of the 
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commands required for handling both the audio and call 
control interfaces as defined by the JavaPhone application.. 
These include: 

I . TapiMakeCall (6621); 
5 2. TapiHoldCall (6622); 

3 . TapiUnholdCall (6623); 

4. TapiBlindXferCall (6624); 

5. TapiDisconnect (6625); 

6 . TapiBlindConf Call (6626); 
10 7 . TapiRetrieveCall (6627); 

8. TapiLogon (6628); 

9 . TapiLogof f (6629); 

1 0 . TapiNo tReady (6631); 

I I . TapiReady (6632); 

15 12. TapiSetVolume (6633); 

13. TapiMicGainSet (6647); 

14. TapiSetProperty (6635); 

1 5 . TapiGetProperty ( 6636 ) ; 

16. TapiShutDown (6637); 
20 17. TapiPing (6638); 

The PlusTapi DLL (110, 6600) also enumerates the 
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following additional commands that to facilitate the usage 
of the JavaPhone APIs in an DA operator environment: 

1 . TapiReadyToggle ( 6641 ) ; 

2 . TapiMuteToggle ( 6642 ) ; 
5 3 . TapiVolumeUp ( 6643 ) ; 

4. TapiVolumeDown (6644); 

5 . TapiMicGainUp (6645) ; 

6. TapiMicGainDown (6646); 

Refer to the section, PlusTapi Enumerated Commands for 

10 additional information . 



The PlusTapi DLL (110, 6600) will display any detected 
errors using standard Windows™ controls (Dialog Boxes, 
Messageboxes, etc.) so as to not tie usage of the PlusTapi 
DLL (110, 6600) with the DISP DLL. In other words, DISP 
15 should not be a prerequisite to usage of PlusTapi. This 
SSj design point implies that although the PlusTapi enumerated 

commands will generate numeric return codes to the calling 
DLL or macro, PlusTapi will automatically generate a 
Windows™ Messagebox containing any error messages to the 
20 operator. In the future this could be changed so that 
PlusTapi would rely on the invoking DLL to either generate 
an error message or handle the failure programmatically . 

PfusTwi startup 

During startup, the PlusTapi DLL (110, 6600) must 
25 perform the required initialization sequence with the 
JavaPhone application. In order to communicate with the 
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JavaPhone application, the PlusTapi DLL (110 , 6600) must 
first establish a TCP/IP socket connection by invoking the 
PlusTcp DLL's Tcpppen command with the appropriate' 
parameters. The TCP/IP address is configured using the 
initialization command enumerated by the PlusTapi DLL (110, 
6600) . .This TCP/IP address will either be the specific 
value assigned to the PC that the JavaPhone software is 
installed on or the string, "localhost" that will indicate 
that the JavaPhone is running on the same PC, The PlusTapi 
DLL (110, 6600) will request the "conversation number" in 
the Tcpppen command that is specified with the utility mode 
setting (see the- section PlusTapi Utility Mode). Retry 
logic is included for establishing the initial socket 
connection. If PlusTapi failed to establish a socket 
connection with the JavaPhone application, none of the 
PlusTapi macro events would have been triggered, resulting 
in the Call Status Window not having any call-related icons 
displayed. 

After the initialization sequence with the JavaPhone is 
completed, the PlusTapi DLL (110, 6600) will request a "DUX 
Advisement" on the DISP sign on operation. This will result 
in PlusTapi being notified whenever the operator performs a 
successful sign on operation. See the next section for 
additional information about operator sign on. 

Note: The remainder of the JavaPhone initialization 
sequence, including the opening of the connections to the 
Call Director and VoD Gateway is not initiated until the 
time of the operator sign on sequence. 

At the completion of its startup logic, the PlusTapi 
DLL (110, 6600) must be prepared to accept any incoming 
calls. This is accomplished through usage of a "callback" 
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routine. This callback routine is identified in the 
enumerated non-persistent variable, (TapiReadAvail) is 
specified in the TcpOpen command. See the section Inbound 
Call Processing for additional information. 

5 Operpfor Sjqn Qn (FIG, 7) 

PlusTapi relies on the operator's invocation of the 
existing DISP sign on operation as a means of obtaining the 
operator's ID (i.e. - user ID) for usage in the logon to the 
Call Director. The workstation is configured to enable the 
10 password validation feature of the MAP . An operator will 
invoke the DISP sign on panel and enter a valid operator ID 
and password. Once the sign on validation is completed, 
DISP will execute a "DUX Advisement" that will in turn 
notify PlusTapi that the sign on has occurred. 

@l 15 Once the operator sign on notification is received, the 

L PlusTapi DLL (110, 6600) will invoke the InitPhone command 

Ul to initialize the telephony environment with the JavaPhone 

application (105, 4400) and provide the address of the 
O "Virtual ACD" . The response to this message will provide a 

20 "telephone handle" that must be used in all subsequent 

operations with the JavaPhone application (105, 4400) so 

that the telephone toolkit can distinguish between different 

clients . 

If the InitPhone request fails, PlusTapi will enter 
25 into a retry sequence that is controlled by the 
corresponding utility mode parameter setting (see PlusTapi 
Utility Mode) . PlusTapi will reissue the InitPhone message 
for the specified duration, pausing one second between each 
attempt. If all retries fail, PlusTapi will also close the 
30 previously opened TCP/IP socket with the JavaPhone 
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application (105, 4400) and then display an error Messagebox 
to the operator. The retry sequence is reinitiated whenever 
a logon sequence is attempted. 

When the response is received for the InitPhone message 
5 to the JavaPhone application, PlusTapi will perform one of 
two possible macro advisements: 

1. TapiEventActive - the telephony environment is 
established and ready to handle calls; 

2. TapiEventlnactive - the telephony environment is 
10 inactive (due to the occurrence of an error) . 

These macro callback events allow the customer to 
update the Call Status Window with textual data indicating 
the status of the operator position. 

Should one of ' both of the connections between the. 

15 JavaPhone and either the Call Director Custom Server or the 
VoD Gateway be lost at any time subsequent to the startup 
sequence, the ConnectionStatusChanged message is sent by the 
JavaPhone application (105, 4400) to PlusTapi. PlusTapi 
will then perform any requested advisements on either the 

20 TapiEventActive or TapiEventlnactive events. PlusTapi will 
next attempt to reestablish the connections by utilizing its 
retry logic as described in the preceding paragraph. If the 
connections are reestablished, PlusTapi will attempt to 
relogon the operator (assuming one was logged on during the 

25 failure) . If all retries to establish the connections fail, 
PlusTapi will close the previously opened TCP/IP socket with 
the JavaPhone application (105, 4400) and then display an 
error Messagebox to the operator. The retry sequence is 
reinitiated whenever a logon sequence is subsequently 

30 attempted. 
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Once the JavaPhone is successfully initialized with the 
InitPhone message, PlusTapi will request two of the 

JavaPhone f s internal properties: 

1. The current headset volume setting (0-100) 

2. The current microphone gain setting (0-100) 

These two values are stored in PlusTapi global (static) 
variables since they is required in any subsequent 
processing of the associated commands used for increasing or 
decreasing these settings. These values will also be 
available as enumerated variables, TapiVolumeLevel and 
TapiMicGainLevel . 

PlusTapi will next attempt to execute the "CalActive" 
command to determine if Common Logon is in effect (the CAL 
DLL is installed) . If so, PlusTapi should inhibit usage of 
the TapiLogon command (accessed through the IWSP 
"DllCommandExecute" entry point), thereby forcing an 
operator to utilize the CAL Common Logon in order to handle 
DA calls. If the CAL DLL is not installed (i.e. - the 
"CalActive" command fails), PlusTapi should set an internal 
state flag indicating that Common Logon is not in effect. 

PlusTapi will then invoke the AgentLogon command of the. 
JavaPhone application. PlusTapi will use the existing DISP 
API to obtain the operator ID that was used for the sign on. 
The JavaPhone application (105, 4400) will perform the 
necessary messaging with the Call Director and eventually 
respond with the AgentLogon response message to PlusTapi. 
The AgentLogon response will contain the logon status and, 
if successful, the "Agent ID". This Agent ID must be saved 
by PlusTapi for usage in other commands subsequently issued 
to the JavaPhone application. 
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If the status received in the AgentLogon response 
indicates a failure, PlusTapi will generate a standard 
Windows™ Messagebox to display the appropriate error message 
to the operator. 

5 After the operator successfully logs on, the position 

will initially be placed in the "not ready" state. The 
operator must toggle to the "ready" state before the first 
call can be received from the Call Director. 

FIG. 7 illustrates an exemplary normal operator sign on 
10 message sequence. 

J Operator Sian Off (FIG. 8) 

SJ When PlusTapi receives a sign off notification from 

DISP, it will issue the AgentLogoff command to the JavaPhone 
W application. In order for a logoff to be initiated to the 

^ 15 Call Director, the following two conditions will apply: 

Ul 1. The operator (agent) must be in the Not Ready state 

s" if 

f% 2. There must not be a call active 

If either of the two conditions is not met, PlusTapi 
will receive an AgentLogoff response with error status. 

20 PlusTapi will subsequently generate a standard Windows™ 
Messagebox to display the appropriate error message to the 
operator. The Logoff operation will then be blocked until 
the operator performs corrective action. Note that if a 
call is active, DISP should prevent the operator from 

25 performing a sign off operation. 

FIG. 8 illustrates an exemplary sign off message 
sequence that would occur when the operator first presses 
the Not Ready" key, followed by the "Sign Off" key. Note: 
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Once the operator sign off sequence is completed, the 
JavaPhone application (105, 4400) will have terminated its 
connections with the VoD Gateway and Call Director. 

Operator Headset fFIG. 9) 

5 The JavaPhone application (105, 4400) apprises the 

PlusTapi DLL (110, 6600) of any change in status of the 
operator headset (plugged or unplugged) by sending the 
HeadSetStatusChanged message. Whenever this message is 
received from the JavaPhone application, PlusTapi will 
10 update its enumerated variable, TapiHeadSetStatus . 

J When the PlusTapi DLL (110, 6600) is notified by the 
JavaPhone application (105, 4400) that the headset has been 

Cfl unjacked, it will first check to assure that a call is not 

U active and then request DISP to perform a sign off operation 

CP 15 by invoking the PosSignOff command. If a call is active 

fn when the headset is unjacked, PlusTapi will display an error 

ttl message to the operator in a standard Windows™ Message box 

ru 

m and then start a timer to allow the operator sufficient time 

Q to jack the headset back in. The length of this timeout is 

20 configured with the PlusTapi utility mode. If the timer 
expires before the headset is plugged back in, PlusTapi will 
initiate the appropriate messaging to the JavaPhone to 
request that the active call be transferred to another 
operator . 

25 Should an operator unjack the headset and walk away 

while a call is active, the exemplary message sequence in 
illustrated in FIG. 9 is generated. 

Inbound Call Processing (FIG. 10) 

After the PlusTapi DLL (110, 6600) has established the 
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socket connection and initialized the JavaPhone telephony 
environment, it must be prepared to accept any incoming 
calls. This is accomplished through usage of a "callback" 
routine as illustrated in FIG. 10. This routine is 
identified in the enumerated non-persistent variable, 
"TapiReadAvail", that is specified in the Tcpppen command. 
Whenever data is received on the socket connection with the 
JavaPhone application, the callback routine specified with 
the TapiReadAvail enumerated variable post a WM_USER message 
to itself so that it can later (on a separate thread of 
execution) perform a TcpRecv operation and parse through the 
message (s) received Note that a single TcpRecv operation can 
contain more than one message from the JavaPhone 
application. 

The basic message format is: 

1. Message Length 

2. Message Type 

3. Message ID 

4. Message Status , 

5. Message Data 

The callback routine must parse through each buffer of 
data received and perform the required actions. 

The PlusTapi DLL's (110, 6600) callback routine will 
handle all incoming calls received over the network. Each 
DA call consists of several messages being sent and received 
between PlusTapi and the JavaPhone application. As can be 
seen in the figure below, the JavaPhone application (105, 
4400) will send two messages on each call arrival: 
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1. CallCreated 

2 . CallStatusChanged 

Once the call is established, PlusTapi will perform any 
requested advisements on the TapiEventCall macro callback 
5 event. This provides a means for the Call Status Window to. 
be updated to reflect that a call is now active. Similarly, 
when the CallRemoved message is received, PlusTapi will 
perform any requested advisements on the TapiEventNoCall 
macro event. This would complete the sequence for each call 
10 arrival. The PlusTapi DLL (110, 6600) contains a state 
machine that tracks the required messaging. 

Any updating of the Call Status Window display (through 
the macro event advisements) is not be performed until all 
of the messaging is completed for the call arrival sequence. 
15 If an unexpected message is received (unknown or out of 
sequence), the error is logged and a standard Windows™ 
Messagebox is generated, informing the operator that an 
error has occurred related to the switch messaging. 

Outbound Call Processing (FIG. 12) 

20 This feature may not be included in many invention 

embodiments. The PlusTapi DLL (110, 6600) allows the 
operator to dial an outbound call. A command, TapiMakeCall , 
can associated with a DISP Macro Key. This command will 
generate a small Windows™ dialog box, allowing the operator 

25 to enter the target phone number. The dialog box should be 
centered in the screen and appear as depicted in the 
exemplary embodiment of FIG. 11. 

The operator is able to enter a phone number that 
contains any number of digits and possibly dashes or 
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parentheses . 



The operator will then either press the 



standard Windows™ Enter key or the Alt^D key combination to 
initiate the dialing sequence. The PlusTapi DLL (110, 6600) 
will then invoke the corresponding JavaPhone command 
(MakeCall) to initiate the call. If the operator presses 
either the standard Windows™ Escape key or the Alt-C . key 
combination, the dialog will be dismissed without the number 
being dialed. 

The JavaPhone application (105, 4400) will produce the 
message sequence as illustrated in FIG. 12. The PlusTapi 
DLL (110, 6600) will generally display any error that is 
detected in a standard Windows™ Messagebox. 

C<tfl Hold Processing (FIG. 13) 

The PlusTapi DLL (110, 6600) supports placing a call on 
hold and removing a call from hold. Three commands are 
defined: 

1 . TapiHoldCall ( 6622 ) ; 

2 . TapiUnholdCall ( 6623 ) ; 

3. TapiHoldToggle (6620) . 

The TapiHoldCall command includes a parameter that 
specifies the Call ID. However, normal usage of this 
command is to leave the parameter blank, placing the active 
call on hold. Whenever this command is invokes, the 
PlusTapi DLL (110, 6600) stores the Call ID of the active 
call so that it can be utilized when the call is removed 
from hold. This command invokes the corresponding JavaPhone 
command, HoldCall. The TapiHoldCall command does not wait 
for the response from the HoldCall command. When the 
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HoldCall response is asynchronously received, PlusTapi 
performs an advisement on the TapiEventHold macro event, 
allowing for an update to the Call Status Window that 
indicates that the call is now on hold. If an error is 
5 received with the HoldCall response, PlusTapi generates a 
Windows™ Messagebox with the error information for the 
operator. 

The TapiUnholdCall command also includes a parameter 
for specifying the Call ID. However, normal usage of this 

10 command is to leave the parameter blank, unholding the last 
call placed on hold through usage of the TapiHoldCall 
command. This command invokes the corresponding JavaPhone 
command (UnholdCall) that requires a Call ID to be 
specified. The TapiUnholdCall command will not wait for the 

15 response from the JavaPhone UnholdCall command. When the 
UnholdCall response is asynchronously received, PlusTapi DLL 
(110, 6600) performs an advisement on the TapiEventUnhold 
macro event, allowing for an update to the Call Status 
Window that indicates that the call is now off hold. If an 

20 error is received with the UnholdCall response, PlusTapi DLL 
(110, 6600) will generate a Windows™ Messagebox with the 
error information for the operator. 

The TapiHoldToggle command performs an internal call to 
either the TapiHoldCall or TapiUnholdCall commands, 

25 depending on the current state of the call. It is 
anticipated that the customer will have a DISP Macro Key or 
IWSP Softkey defined that includes this command, allowing 
the operator to press a single key that will either place 
the call on hold or remove it from hold. Through usage of 

30 the Call Status Window, the operator should also be 
presented with a visual indication of the current hold 
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status . 

FIG. 13 illustrates an exemplary message sequence 
involved with a call hold and unhold operation. 

Call Transfers (FIG. 14) 

5 This feature is optional in a production system. 

PlusTapi (110, 6600) allows the operator to transfer an 
active call to another number. The command, 

TapiBlindXf erCall, accepts a single parameter that specifies 
the target phone number to transfer the active call to. If 
10 the parameter is left blank, the DialNumber Dialog as shown 
in FIG. 11 is displayed. The TapiBlindXf erCall command 

Id invokes the corresponding command, BlindTransf erCall , of the 

Hi 

m JavaPhone application, supplying the Call ID of the active 

^ call and the target phone number (from either the dialog box 

m 15 or command parameter) . 



IS; 5 



PlusTapi (110, 6600) performs the required messaging 
with the JavaPhone application (105, 4400) to complete the- 
call transfer operation. FIG. 11 shows the message sequence 
involved with a call transfer in which the operator enters 
20 another phone number using the Dial Number Dialog box (FIG. 
11) . 



Call Conferencing (FIG. 15) 

PlusTapi (110, 6600) allows the operator to conference 
an active call with another party, another available 
25 operator, or another available supervisor. The command, 
TapiBlindConfCall, accepts a single parameter that specifies 
the target phone number to include in the conference with 
the active call. If the parameter is left blank, the Dial 
Number Dialog as illustrated in FIG. 11 is displayed. The 
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TapiBlindConfCall command invokes the corresponding command, 
BlindConf erenceCall , of the JavaPhone application, supplying 
the Call ID of the active call and the target phone number 
(from either the dialog box or command parameter) . 

5 PlusTapi DLL (110, 6600) performs the required 

messaging with the JavaPhone application (105, 4400) to 
complete the call conference operation. FIG. 16 contains 
the message flow for a call conferencing operation between 
the caller, the operator, and another supervisor. In the 
10 depicted scenario, the operator eventually presses the 
DisconnectCall key to drop off the call, leaving the 
supervisor connected. with the caller. 

Call Disconnect (FIG. 16) 

When the operator has a need to disconnect from an 
15 active call, the JavaPhone DisconnectCall command is 
generated through a DISP Macro key or Softkey invoking the 
PlusTapi TapiDisconnect command. 

FIG. 16 illustrates an exemplary message sequence that 
may occur when the operator presses the "DisconnectCall" key 

20 Readv/Not Ready Controls 

Three commands are enumerated by PlusTapi for 
controlling the Ready /Not Ready status of the workstation: 

1. TapiReady (6632); 

2 . TapiNotReady ( 6631 ) ; and 
25 3. TapiReadyToggle (6641) . 

The first two commands can be assigned to separate DISP 
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Macro keys. However, it is anticipated that the customer 
will prefer to use the toggle function provided with the 
third command, TapiReadyToggle . The TapiReadyToggle command 
tracks the current state of the position and internally 
5 invokes either the TapiReady or TapiNotReady command, 
depending on the current state of the position. 

There are three possible macro events that can be 
triggered through usage of the above commands: 

1 . TapiEventReady 

10 2. TapiEventNotReady 

3 . TapiEventNotReadyPend 

If a call is active when the operator requests to be 
placed in the "not ready" state, the operator will first be 
placed in the "not ready pending" state. This will prevent 

15 any subsequent calls from being sent to the position; 
however, the operator will not enter the "not ready" state 
until the active call has completed. The PlusTapi DLL 
tracks the "pending" state since the JavaPhone and Call 
Director consider the operator in the "not ready" state even 

20 when a call is active. This implies that PlusTapi must know 
to trigger the macro event, TapiEventNotReady, whenever the 
active call is terminated during a "not ready pending" 
state . 

The TapiReady and TapiNotReady commands do wait for the 
25 response from the corresponding JavaPhone commands. When the 
responses are asynchronously received, PlusTapi will perform 
an advisement on either the TapiEventReady or 
TapiEventNotReady macro events. This provides for a means of 
updating the Call Status Window with an indication of the 
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agent's state. If an error is received with the JavaPhone 
response, PlusTapi will generate a Windows Messagebox 
containing with the error information for the operator. 

Volume Control 

Three commands are enumerated by PlusTapi (110, 6600) 
for controlling the volume of the headset: 

1 . TapiVolumeUp (6643); 

2 . TapiVolumeDown (6644) ; 

3. TapiVolumeSet (6633). 

Each of these commands requires a parameter with a. 
value of 1 to 100, indicating the amount to increase or 
decrease the headset volume. Since the JavaPhone 

application (105, 4400) sets the absolute value of the 
volume (not an increase or decrease) through a property 
setting, the PlusTapi DLL (110, 6600) tracks the current 
value that was last used with the SetProperty command. When 
the TapiVolumeUp command is invoked, the value provided as 
the parameter of this command is used as the increment to 
the current value (the value last specified with the 
SetProperty command) . The incremented value is saved as the 
current headset volume and used as the parameter for the 
SetProperty command. Similarly, the TapiVolumeDown command 
will decrement the current value and then pass it as the 
parameter in the JavaPhone SetProperty command. 

The TapiVolumeSet command would be used to set the 
volume to an absolute value by passing it a parameter 
indicating the percentage of full volume (0 - 100) . This 
command could be used to reset the volume to a predetermined 
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acceptable setting, allowing the operator to press a single 
key after having temporarily adjusted the volume manually. 
It could also be used in a start-up macro as a means of 
setting the volume to a predefined value. 

PlusTapi will provide a macro callback event that would 
allow the user to configure the Call Status Window to 
contain a single InfoWin Field that displays the numeric- 
value of the volume setting (0-100). 

Four commands are enumerated by PlusTapi DLL (110, 
6600) for controlling the microphone gain: 

1. TapiMicGainUp (6645); 

2 . TapiMicGainDown ( 6646 ) ; 

3 . TapiMicGainSet ( 6647 ) ; 

4 . TapiMuteToggle ( 6642 ) ; 

Each of these commands require a parameter with a value 
of 1 to 100, indicating the amount to increase or decrease 
the microphone gain (the volume that the subscriber hears) . 
Since the JavaPhone application (105, 4400) sets the 
absolute value (not an increase or decrease) of the 
microphone gain with the SetProperty command, the PlusTapi 
DLL (110, 6600) tracks the current setting that was last 
used with the SetProperty command. When the TapiMicGainUp 
command is invoked, the value provided as the parameter of 
this command is used as the increment to the current value 
(the value last specified with the SetProperty command) . 
The incremented value is saved as the current microphone 
gain value and used as the parameter for the SetProperty 
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command. Similarly, the TapiMicGainDown command will- 
decrement the current value and then pass it as the 
parameter in the JavaPhone SetProperty command. 

The TapiMicGainSet command would be used to set the 
microphone gain to an absolute value by passing it a 
parameter indicating the percentage of full gain (0 - 100) . 
This command could be used to reset the microphone gain to a 
predetermined acceptable range, allowing the operator to 
press a single key after having temporarily adjusted the 
gain manually. 

The TapiMuteToggle command acts as a microphone mute 
toggle function. If the current microphone gain setting is 
non-zero, this command sets the microphone gain to zero 
(i.e. -mute the microphone) and saves off the previous 
setting. If the current microphone setting is zero, this 
command restores the previous setting (i.e. - unmute the 
microphone) . 

PlusTapi also provides a macro callback event that 
would allow the user to configure the Call Status Window to 
contain a single InfoWin Field that displays the numeric 
value of the gain setting (0-100) . 

Property Settings 

The JavaPhone application (105, 4400) contains a set of 
"properties" that can be accessed or altered. The property 
values, are displayed in the following table: 



Table 1: Property Settings 



Property name 


Property values 


HoldPlayFile 


A wave file name (e. g. - "c:\iws 
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\holdmusic . wav" 


AudioDevice 


ShelCad SoundCard 


AudioMode 


HeadSet 




FullDuplex 




Half DuplexAuto 




Half DuplexMan 


ComPort 


1 




o 
2. 




3 




4 


Gateway Address 


The default PSTN gateway address 


AudioCoder 


G711AL 




G711ML 




G723 




POM 




AUTO 


Connect ionType 


Dial Up LAN 


Volume 


1 - 100 


MicGain 


1 - 100 



PlusTapi enumerates two commands: 

1 . TapiSetProperty (6635 ) ; 

2. TapiGetPropery (6636). 



The TapiSetProperty (6635) command can be used to 
5 select one of the available properties and change its value. 
The TapiGetProperty (6636) command will retrieve the named 
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property and display it in a standard Windows™ Messagebox. 
These commands will invoke the corresponding SetProperty and 
GetProperty commands of the JavaPhone application. It is 
not anticipated that either of these commands is needed for 
5 operator usage but are provided for potential administrative 
or diagnostic purposes. 

Shutdown 

The PlusTapi DLL (110, 6600) implementation of the IWSP 
"DLLTerminate" API routine invokes the ShutDown command to 
the JavaPhone application (105, 4400) so that it can perform 
its required termination across the TAPI interface. 

PlusTapi DLL (110, 6600) can also receive the ShutDown 

message from the JavaPhone unsolicitedly due to some, 
external event (from the Call Director, VoD Gateway, etc.). 
In this case, PlusTapi DLL (110, 6600) clears the internal 
state (assume all calls have been terminated and the 
operator is already logged off) and initiate a DISP signoff. 

PlusTaoi Enumerated Commands (6602) 

The following sections provide the formats for each of 
the proposed commands that is enumerated by the PlusTapi DLL 
(110, 6600) . Additional information about the corresponding 
JavaPhone commands can be found in the JTAPI standard 
specification. 

TapiMakeCall (6621) 

25 This feature is optional in the production system. 

This command is used to establish a phone call to the 
requested address. When only a telephone number is given, 
the default gateway address is used. This command will 
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generate a Windows™ Dialog box as described in the section, 
Outbound Call Processing. This command will invoke the 
JavaPhone's Make Call command once the operator enters the 
target phone number. 







TapiMakeCall ( sPhoneNumber ) 




Parameters : 


sPhoneNumber 


The phone number to be 
dialed If thi q 

V-A -1- CA _J_ . -1_ JL till O 

parameter is blank, a 
Windows™ dialog box is 
displayed (see the 








section Dial be Number 


yfl 






Dialog) 




Returns : 


PLU S__COMMAN D_OK 


Command executed 








successfully. 






PLUS_COMMAND_ 


PlusTapi DLL not 






NOT_AVAIL 


installed. 


: 

§ ; y 




PLU S__COMMAN D_E RR 


General failure 


ru 




OR 


occurred. 



5 TapiHoldCall (6622) 

This command will place a call on hold. When no call 
id is specified (normal usage) the active call is put on 
hold. When a successful response to this message from the 
JavaPhone application (105, 4400) is received, PlusTapi will 
10 perform any requested advisement on the TaptiEventHold macro 
event . 
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Format : 


TapiHoldCall (sCalllD) 


Parameters : 


sCalllD 


The specified Call ID 
that should be put on 
hold. This parameter 
would normally be blank 
to lace the current call 
on hold. 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 




PLUS COMMAND 
NOT_AVAIL 


PlusTapi DLL not 
installed. 




PLUS_COMMAND_ 
ERROR 


General failure 
occurred. 


TapiUnholdCall 


(6623) 





This command will remove the specified call from hold. 
When no call ID is provided (normal usage) it will unhold 
the last call placed on hold. When a successful response to 
this message from the JavaPhone application (105, 4400) is 
received, PlusTapi will perform any requested advisements on 
the TapiEventUnhold user exit. 
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Format : 


TapiUnHoldCall (sCalllD) 


Parameters : 


sCalllD 


The Call ID that should 
be taken off hold. This 
parameter would normally 
be blank to unhold the 
last call placed on hold 
with the TapiHoldCall 
command. 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 




rLUc O UlXll v l/iiN U 
NOT_AVAIL 


T") 1 , , rp _ v~ J T~\T T « a4- 

riusiapi DLL not 
installed. 




PLUS_COMMAND_ 
ERROR 


General failure 
occurred. 


TapiHoldToggle 


(6620) 





This command will toggle the hold state of the 
specified call. When no call ID is provided (normal usage) 
it will unhold the last call placed on hold or place the 
active call on hold. When a successful response to this 
message from the JavaPhone application (105, 4400) is 
received, PlusTapi will perform any necessary advisements on 
either the TapiEventHold or the TapiEventUnhold macro 
events . 
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Format : 


TapiHoldToggle (sCalllD) 


Parameters : 


sCalllD 


The Call ID that should 
be placed on hold or 
taken off hold. This 
parameter would normally 
be blank to hold the 
active call or unhold 
the last call placed on 
hold with the 
TapiiHoldCall command . 


Returns : 


PLU S_COMMAN D_OK 


Command executed 
successfully. 




PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 




PLUS_COMMAND_ 
ERROR 


General failure 
occurred. 



TapiBlindXferCall (6624) 



Note: this feature may not be included in many 
invention embodiments. This command is used to transfer a 
call to another party (which is not connected yet), and 
retrieves the next call in the queue. This command can also 
be used for transferring the call to either another 
available operator or a supervisor by setting the 
sPhoneNumber parameter to one of the following: 

1. C0DEOPERAT0R 

2. CODE=SUPERVISOR 
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Format : 


TapiBlindXferCall (sPhoneNumber) 


Parameters : 


sPhoneNumber 


The phone number to be 
dialed. If this 
parameter is blank, a 
Windows™ dialog box is 
displayed (see the 
section Dial Number 
Dialog) 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 




PLUS COMMAND 
NOT_AVAIL 


PlusTapi DLL not 
installed. 




PLUS_COMMAND_ 
ERROR 


General failure 
occurred. 


TapiDisconnect 


(6625) 





Ml This command will disconnect the identified call or the 

fi? 

fli active call if none is specified. 
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Format : 


TapiDisconnect (sCalllD) 


xr a. L altlc L tr £ o . 


sCalllD 


The Call ID that is to 
be disconnected. If 
this parameter is blank, 
the currently active 
call is disconnected. 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 




PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 


PLUS_COMMAND_ERR 
OR 


General failure 
occurred. 




-3 


No call active or 
invalid Call ID. 



TapiBlindConf Call (6626) 



This command will initiate a conference call with a 
third party. This command can also be used for transferring 
the call to either another * available operator or a 
supervisor by setting the sPhoneNumber parameter to one of 
the following: 

1 . CODE=OPERATOR 

2. CODE=SUPERVISOR 
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Format : 


TapiBlindConfCall (sPhoneNumber) 


Parameters : 


sPhoneNumber 


This phone number is to 
be dialed. If this 
parameter is blank, a 
Windows™ dialog box is 
displayed (see the 
section Dial Number 
Dialog) 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 




PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 




PLUS_COMMAND_ 
ERROR 


General failure 
occurred. 




-3 


No call active or 
invalid phone number. 



TapiDTMF (6640) 



This command will generate a DTMF (Dual Tone Multi- 
frequency) signal via the JavaPhone application. This 
command can be utilized to send individual DTMF signals or 
multiple signals (for multiple digits) . For example, to' 
send individual signals, separate commands could be assigned 
to a numeric keypad (e.g., numeric keypad digit 7 would 
invoke the command TapiDTMF (7), which would result in a 
single DTMF for number 7 being generated. 
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Format : 


TapiDTMF (s Digits) 


Parameters : 


sDigits 


One or more digits for 
which to generateDTMF 
signals . 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 


PLUS COMMAND 
NOT_AVAIL 


PlusTapi DLL not 
installed. 




PLUS_COMMAND_ 
ERROR 


General failure occurred. 




-3 


No call active 



TapiLogon (6628) 



PlusTapi will store the "Agent ID" returned from the 
JavaPhone with a successful logon for usage with subsequent' 
commands that require this parameter. 



Format : 


TapiLogon (sUserlD, sPassword) 


Parameters : 


sUserlD 


The User ID of the 
operator 




sPassword 


The password of the 
operator 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 




PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 




PLUS_COMMAND 
ERROR 


General failure 
occurred. 
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TapiLogoff (6629) 

Note that the "Agent ID" used in the invocation of the 
corresponding parameter of this command can either be 
supplied (most likely by another DLL or stand-alone 
application) or if left blank, PlusTapi will supply the 
Agent ID returned with the last successful logon. 



Format : 


TapiLogoff (sAgentID) 


Parameters : 


sAgentID 


The Agent ID of the 
operator, returned with 
a previous logon. If 
this parameter is left 
blank, PlusTapi will use 
trie Agent ID tnat it 
stored internally from 
the last successful 
logon. 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 




PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 




PLUS_COMMAND_ 
ERROR 


General failure 
occurred. 


TapiReadyToggle 


(6641) 





PlusTapi DLL (110, 6600) will track the current state 
of the agent (either "ready" or "not ready") . Invocation of 
this command will toggle the position from its current 
state. When a successful response from the JavaPhone 
application (105, 4400) is received for this message, 
PlusTapi DLL (110, 6600) will perform any necessary 
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advisements on either the TapiEventReady, TapiEventNotReady, 
or the TapiEventNotReadyPend macro event. 





Format : 


TapiReadyToggle (sAgentID) 




Parameters : 


o/\gen n u 


ine Agent ID of the 








operator, returned with 








a previous logon. If 








this parameter is left 








blank, PlusTapi DLL 








(110, 6600) will use 








the Agent ID that it 








stored internally from 


§n 






the last successful 








logon . 




Returns : 


PLUS_COMMAND_OK 


Command executed 


su* - 






successfully. 






PLUS_COMMAND_ 


PlusTapi DLL not 


: 51 
| |._: 




NOT_AVAIL 


installed. 






PLUS_COMMAND_ 


General failure 






ERROR 


occurred. 



TapiNotReady (6631) 



Invocation of this command will change the current 
5 state of the agent to "not ready". When a successful 
response to this message from the JavaPhone application 
(105, 4400) is received, PlusTapi DLL (110, 6600) will 
perform any requested advisements on either the 
TapiEventNotReady (if no call is active) or the 
10 TapiEventNotReadyPend (if a call is active) macro event. 
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Format : 


TapiNotReady (sAgentID) 


Parameters : 


sAgentID 


The Agent ID of the 
operator, returned with 
a previous logon. If 
this parameter is left 
blank, PlusTapi will use 
the Agent ID that it 
stored internally from 
the last successful 
logon . 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 




PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 




PLUS_COMMAND_ 
ERROR 


General failure 
occurred. 



TapiReady (6632) 



Invocation of this command will change the current 
state of the agent to "ready". When a successful response 
to this message from the JavaPhone application (105, 4400) 
is received, PlusTapi DLL (110, 6600) will perform any 
requested advisements on the TapiEventReady macro event. 
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Format : 


TapiReady (sAgentID) 


Parameters : 


s Agent ID 


The Agent ID of the 
operator, returned with 
a previous logon. If 
this parameter is left 
blank, PlusTapi will 
use the Agent ID that 
it stored internally 
from the last 
successful to logon 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 




PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 




PLUS_COMMAND_ 
ERROR 


General failure 
occurred. 



TapiVolumeUp (6643) 



This command will increase the level of the headset 
volume by the specified amount. For example, if the current 
volume is set to the value of 60 (60% maximum volume), the 
command TapiVolumeUp ( 1 0 ) would change the current volume 
setting to 70 (70% of maximum) . When a successful response 
to this message from the JavaPhone application (105, 4400) 
is received, PlusTapi DLL (110, 6600) will perform any 
requested advisement on the TapiEventVolChange macro event. 
A value for the sPercentagePoints parameter which would 
increase the current setting to a value which is greater 
than 100 will set the volume to 100%. 
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Format : 


TapiVolumeUp (sPercentagePoints) 


Parameters : 


s Percentage Point 
s 


The number of 
percentage points (1- 
100) that the headset 
volume should be 
increased. 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 




PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 




PLUS_COMMAND_ 
ERROR 


General failure 
occurred. 



TapiVolumeDown (6644) 



This command will decrease the level of the headset 
volume by the specified amount. For example, if the current 
volume is set to the value of 60 (60% maximum volume) , the 
command TapiVolumeDown ( 1 0 ) would change the current volume 
setting to 50 (50% of maximum) . When a successful response 
to this message from the JavaPhone application (105, 4400) 
is received, PlusTapi will perform any requested advisements 
on the TapiEventVolChange macro event. A value for the 
sPercentagePoints parameter which would decrease the current 
setting to a value that is less than 0 will set the volume 
to 0%. 
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Format : 


TapiVolumeDown (sPercentagePoints) 


Parameters : 


s Per cent agePoints 


The number of percentage 
points (1-100) that the 
headset volume should be 
decreased. 


Returns : 


PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 


PLUS_COMMAND_ERROR 


General failure 
occurred. 



TapiVolumeSet (6633) 

This command will set the level of the headset volume 
to the specified percentage of full volume. For example, if 
the current volume is set to the value of 80 (80% maximum 
5 volume), the command TapiVolumeSet ( 50) would change the 
current volume setting to 50 (50% of maximum) . When a 
successful response to this message from the JavaPhone 
application (105, 4400) is received, PlusTapi will perform 
any requested advisements on the TapiEventVolChange macro 
10 event. 
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Format : 


TapiVolumeSet ( sPercentage) 


Parameters : 


sPercentage 


The percentage (0-100) of 
maximum volume that the 
headset volume should be 
set to. 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 


PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 


PLUS_COMMAND_ 
ERROR 


General failure occurred. 



TapiMicGainUp (6645) 



This command will increase the level of the microphone 
gain by the specified amount. For example, if the current 
microphone gain is set to the value of 60 (60% maximum 
gain), the command TapiMicGainUp ( 10) would change the 
current gain setting to 70 (70% of maximum). When a 
successful response to this message from the JavaPhone 
application (105, 4400) is received, PlusTapi will perform 
any requested advisements on the TapiEventGainChange macro 
event. A value for the sPercentagePoints parameter which 
would increase the current setting to a value which is 
greater than 100 will set the microphone gain to 100%. 
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Format : 


TapiMicGainU (sPercentagePoints) 


Parameters : 


s Per cent agePoints 


The number of percentage 
points (1-100) that the 
microphone gain should 
be increased by. 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 


PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 


P L U S_C OMMAN D_E RRO R 


General failure 
occurred. 



TapiMicGainDown (6646) 



This command will decrease the level of the microphone 
gain by the specified amount. For example, if the current 
microphone gain is set to the value of 60 (60% maximum 
gain), the command TapiMicGainDown ( 10 ) would change the 
current gain setting to 70 (70% of maximum) . ' When a 
successful response to this message from the JavaPhone 
application (105, 4400) is received, PlusTapi will perform 
any requested advisements on the TapiEventGainChange macro 
event. A value for the sPercentagePoints parameter which 
would decrease the current setting to a value that is less 
than 0 will set the microphone gain to 0%. 
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Format : 


TapiMicGainUp (sPercentaePoints) 


Parameters : 


sPercentage 
Points 


The number of percentage 
points (1-100) that the 
microphone gain should be 
increased by. 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 




PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 




PLUS_COMMAND_ 
ERROR 


General failure occurred. 



ff] TapiMicGainSe t (6647) 

pi" 

Co This command will set the level of the microphone gain 

to the specified percentage of maximum gain. For example, 

0 if the current microphone gain is set to the value of 80 

1 i ; 

Sj 5 (80% maximum gain), the command TapiMicGainSet (50 ) would 
[y change the current gain setting to 50 (50% of maximum) . 

p When a successful response to this message from the 

JavaPhone application (105, 4400) is received, PlusTapi will 
perform any requested advisements on the TapiEventGainChange 
10 macro event. 
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Format : 


TapiMicGainSet (sPercentage) 


Parameters : 


sPercentage. 


The percentage 
(0-100) of 
maximum that the 
micro hone gain 
should be set to. 


Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 




PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 




PLUS_COMMAND_ERROR 


General failure 
occurred. 



TapiMu teToggle (6642) 



This command is a microphone mute toggle function. 
PlusTapi DLL (110 , 6600) will check the current setting of 
the microphone gain (stored internally) . If the gain is 
currently set to a non-zero value, PlusTapi will save the 
current setting and then set the microphone gain to zero 
(i.e. - the microphone is muted) . If the gain is currently 
zero, PlusTapi will restore the previously saved setting. 
When a successful response to this message from the 
JavaPhone application (105, 4400) is received, PlusTapi will 
perform any necessary advisements on either the 
TaptEventMute or TapiEventUnmute macro event. 
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Format : 


TapiMuteJToggle ( ) 


Parameters : 


None 




Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 


PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 




PLUS_COMMAND_ 
ERROR 


General failure 
occurred. 



TapiSetProperty (6635) 



This command is used for changing one of the available 
properties in the JavaPhone application. Refer to the" 
Property Settings table in FIG. 17 for additional 
5 information on the available properties and their possible 
values. Note that all property names and values are 
provided in string format. 



Format : 


TapiSetProperty ( sPropertyName, sProperty 
Value) 


Parameters : 


sPropertyName 


The name of the 
JavaPhone application 
property that is to be 
updated. 


sProperty Value 


The new property value. 


Returns : 


PLUS__COMMAND_OK 


Command executed 
successfully. 


PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 


PLUS__COMMAND_ 


General failure 
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10 



ERROR 



occurred. 



TapiGe tProperty (6636) 

This command is primarily intended for diagnostic 
purposes. It will request the specified property from the 
JavaPhone application (105, 4400) and display it in a 
standard Windows™ Messagebox. 





Format : 


TapiGe t Property (sPropertyName) 




Parameters : 


s Proper tyName 


The name of the 








JavaPhone application 


i 






property that is to 


j.ys 






be accessed and 








displayed in a 


3335: 






Windows™ Messagebox. 


fc* ; 


Returns : 


PLUS_COMMAND_OK 


Command executed 








successfully. 


SSI ' 




PLUS_COMMAND__ 


PlusTapi DLL not 


i y 

i y 
pi 




NOT_AVAIL 


installed. 


0 




PLUS_COMMAND_ERROR 


General failure 








occurred. 



TapiShutDown (6637) 

This command can be invoked in order to request the 
JavaPhone application (105, 4400) to terminate. Note that 
this command would not be needed for normal workstation 
operation as the PlusTapi DLL (110, 6600) will terminate the 
JavaPhone application (105, 4400) when D1SP/IWSP terminates. 
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Format : 


TapiShutDown ( ) 


Parameters : 


None 




Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully . 




PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 




PLUS_COMMAND_ 
ERROR 


General failure 
occurred. 



TapiPing (6638) 



This diagnostic command can be used to test the message 
path between the client application and the Call Director by 
sending a test message. PlusTapi will send the 

corresponding message to the JavaPhone application. When 
the response is received, PlusTapi will generate a standard 
Windows™ Messagebox informing the user that the ping 
response has been received. 



Format : 


TapiPing ( ) 


Parameters : 


None 




Returns : 


PLUS_COMMAND_OK 


Command executed 
successfully. 




PLUS_COMMAND_ 
NOT_AVAIL 


PlusTapi DLL not 
installed. 




PLUS_COMMAND_ERROR 


General failure 
occurred. 



TapiDi splayEr r s (6648) 

This command is used for setting the operating mode of 
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the PlusTapi DLL (110, 6600). When the parameter, sParm, is 
set to "YES", PlusTapi DLL (110, 6600) will generate a 
Windows™ Messagebox containing an informative message 
whenever an error is detected during the execution of one of 
the available PlusTapi commands. When the parameter, sParm, 
is set to "NO", PlusTapi will not display any Messageboxes 
but will instead report all failures back through the IWSP 
API. The default setting after startup is to display errors' 
to the operator. 



Format : 


TapiDisplayErrs (sParm) 


Parameters : 


sParm 


The sParm is set to one 
of two possible values: 

YES 

NO 


Returns : 


PLUS_C0MMAND_0K 


Command executed 
successfully. 




PLUS_COMMAND_ 
N0T_AVAIL 


PlusTapi DLL not 
installed. 




PLUS _C OMMAN D_E R RO R 


General failure 
occurred. 



PlusTapi Enumerated Data Variables 



The PlusTapi DLL (110, 6600) will enumerate variables 
to the IWSP platform containing the following audio and call 
status values: 

1 . TapiPositionStatus 

2 . TapiLogonStatus 



3 . TapiAgentID 
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4 . TapiCalllD 

5 . TapiCallStatus 

6 . TapiPartyStatus 

7 . TapiVolumeLevel 
5 8 . TapiMicGainLevel 

9 . TapiHeadSetStatus 

Each of the above-enumerated variables also support the 
generation of DLL and DDE advisements whenever their values 
are altered. 

10 PlusTapi DLL (110, 6600) also enumerates two variables 

used for recording error conditions: 

1 . TapiLastErrCode 

2 . TapiLastCmdErr . 

The descriptions of these variables are provided in the 
15 following sections. 

TapiPositionStatus 

This data item contains the status of the position as 
follows : 

1. 0 - Idle (not logged on) 
20 2. 1 - Position ready to accept calls 

3. 2 - Position not ready to accept calls 

4. 3 - Position has call active 
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A value of 0 indicates that no operator has logged on. 
All other states imply that an operator has successfully 
logged on. 

Format: NULL terminated ASCII string (1 character 
5 plus terminating NULL) 

TapiLogonStatus 

This data item contains the string returned from the' 
JavaPhone application (105, 4400) and the Call Director in 
the AgentLogon response message. 

10 Format: NULL terminated ASCII string 

TapiAgentID 

This data item contains the current Agent ID returned 
from the JavaPhone application (105, 4400) after a 
successful logon to the Call Director. If the position is 
15 not presently logged on, the variable is NULL. 

Format: NULL terminated ASCII string 
TapiCalllD 

This data item contains the current Call ID that was 
received from the JavaPhone application. If no call is 
20 active, the variable is NULL. 

Format: NULL terminated ASCII string 

TapiCallStatus 

This data item contains the status of the current call 
in the JavaPhone application. It will contain one of the 
25 following enumerated strings, or NULL if no call is active: 
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1. INITIATED 

2. RINGING 

3 . TALKING 

4. HELD 

5. DIALING 

Format: NULL terminated ASCII string 

TapiPartyStatus 

This data item contains the party status of the current 
call in the JavaPhone application. It will contain one of 
the following enumerated strings, or NULL if no call is 
active : . 

1. INITIATED 

2 . ALERTED 

3. TALKING 

4 . HELD 

Format: NULL terminated ASCII string 

TapiVolumeLevel 

This data item contains the current volume level 
setting of the headset. Possible values are 0 to 100. 

Format: NULL terminated ASCII string (1 to 3 digits 
plus a NULL) 

TapiMicGainLevel 

This data item contains the gain setting of the 
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Ml 



microphone. Possible values are 0 to 100. 

Format: NULL terminated ASCII string (1 to 3 digits 
plus a NULL) . 

TapiHeadSetStatus 

5 This variable contains the current status of the 

operator headset as indicated in the HeadSetStatusChanged 

message most recently received from the JavaPhone. 
application. It contains one of the two following values: 

1. IN 

10 2. OUT 

Format: NULL terminated ASCII string 

TapiConnectionStatus 

This variable contains the current status of the 
JavaPhone connections to the Voice Over Data Gateway and the 
15 Call Director. It contains one of the two following values: 

1. Connected 

2. Disconnected 

Format: NULL terminated ASCII string 



TapiLas tEr r Code 

20 This data item contains the return code value received 

during the execution of the last command that failed or was 
generated by a PlusTapi internal error. This variable is 
automatically cleared when its value has been requested. 
Other IWSP DLLs or standalone applications can respectively 

25 request a DUX or DDE advisement whenever this variable is 
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changed. This will allow for the requesting application to 
be informed whenever an error is asynchronously received 
from the JavaPhone application. 

Format: short 

TapiLastCmdErr 

This data item contains the name of the last command 
that failed during its execution. This variable is 
automatically cleared when its value has been requested. 
Note that this variable can be NULL (even when the 
TapiLastErrCode contains a value) if the error is due to a 
condition that was not the direct result of executing one of 
the available PlusTapi commands. 

Format: NULL terminated ASCII string (up to 24 
characters plus terminating NULL) 

Ply$T?pj Frror Hanging 

PlusTapi has two modes of operation related to error 
handling: 

1. "Error Display" mode - any detected errors is 
reported to the operator in a Windows™ Messagebox. 

2. "No Display" mode - any detected errors is 
reported back through the IWSP API without being displayed 
tP the operator in a Messagebox. 

The "Error Display" mode is the default setting for the 
position after successful startup. The "No Display" mode, 
can be selected only through the invocation of the provided 
command, TapiDisplayErrs . With this mode, errors are 
reported back through the IWSP platform so that the invoking 
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IWSP DLL or standalone application (using DDE) can handle 
the error programmatically . 

Whenever any of the PlusTapi DLL (110 , 6600) enumerated 
commands experiences a failure (regardless of the operating 
5 mode), PlusTapi will store the specific return code (e.g., 
as provided by the JavaPhone application) in the enumerated 
variable, TapiLastErrCode . The command that generated the 
failure (if any) will also be stored in the enumerated 
variable, TapiLastCmdErr . If PlusTapi is in the "Error- 
10 Display" mode, the command will always return the 
PLUS_COMMAND_OK status to the platform after the Messagebox 
is displayed. If PlusTapi is in the "No Display" mode, the 
command will always return the general failure status, 
PLUS_COMMAND_ERROR, to the invoking IWSP DLL or standalone 
15 application whenever the error is detected on the same 
?fi thread of execution. In the case that the error is received 

with an asynchronous response from the JavaPhone 
yi application, PlusTapi will perform any DUX or DDE 

^ advisements previously requested on the TapiLastErrCode 

Q 20 variable. The invoking application should then immediately 
request the TapiLastErrCode and the TapiLastCmdErr values 
whenever failure status is returned. 

Any of the JavaPhone responses that report an error 
will include a return code. PlusTapi (110, 6600) enumerates 

25 a message string for each of the possible error conditions, 
allowing the customer to alter the textual content through 
usage of the IWSP Define Language utility. Errors will 
normally be reported to the operator by displaying a 
standard Windows™ Messagebox. PlusTapi will also generate a 

30 Windows™ Messagebox for each of the possible errors that can 
be returned by the PlusTcp DLL. Note that the strings for 
each corresponding error that the PlusTcp DLL can detect are 
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enumerated by the PlusTcp DLL (109, 5500) (even though it 
will always return a numeric return code and never display 
any text) . 

PlusTapi (110, 6600) attempts to recover from 
conditions involving lost connections between the JavaPhone 
application (105, 4400) and either the Voice Over Data 
Gateway or the Call Director. The recovery involves a retry 
sequence that is described in section PlusTapi Startup. 
PlusTapi will not attempt to recover from any severe errors 
received either from PlusTcp or the JavaPhone. All errors 
will also be logged. 

PlusTapi Mawo A4yis$ment Events 

PlusTapi (110, 6600) also supports "DUX" macro callback 
advisements on selected "events", allowing for the 
invocation of user-defined macros. This macro advisement 
support is utilized for displaying informational text in the 
Call Status Window (CSW) display. 

The following PlusTapi events that support DUX macro 
invocations is supported: 

1. TapiEventActive - JavaPhone environment has been 
successfully initialized 

2. TapiEventlnactive - JavaPhone environment has not been 
successfully initialized 

3. TapiEventMute - Microphone was muted 

4. TapiEventUnMute - Microphone was unmuted 

5. TapiEventHold - Call has been placed on hold 
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6. TapiEventUnhold - Call has been removed from hold 

7. TapiEventReady - Agent has been made ready to accept 
new calls 

8. TapiEventNotReady - Agent has been made not ready to 
accept new calls 

9. TapiEventNotReadyPend - Agent is made not ready to 
accept new calls after the active call ■ has been 
terminated. 

10. TapiEventVolChange - the headset volume was altered 

11. TapiEventGainChange - the microphone gain was altered 

12. TapiEventCall - A call is active on the position 

13. TapiEventNoCall - No call is active on the position 

The above events will perform the internal 
DuxExecMacroAdvise command that will execute any macro 
previously identified with the Dux&tMacroAdvise command. 

Through usage of the existing DuxSetMacroAdvise 

command, the position can be configured to update the Call 
Status Window with either text or an icon. For example, if. 
the IWSP startup macro (configured in the Platform Setup 
utility) was defined to include the following commands: 

1 . DuxSetMacroAdvise (TapiEventHold, HoldMacro) ; 

2 . DuxSetMacroAdvise (TapiEventUnhold, UnholdMacro) ; 
and the "HoldMacro" was defined as: 

InfoWinSetText (1, 0, "Call On Hold"); 
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and the UnholdMacro was defined as: 

Inf oWinSetText ( 1 , 0 , " " ) , 

then the operator would have visual feedback whenever the' 
call was placed on hold. 

5 Similarly, the other DUX user exits in PlusTapi would 

be configured to display text in predefined InfoWin Fields. 
See the section Call Status Window for additional 
information. 

The TapiEventActive advisement is made when PlusTapi 
10 establishes communications with the JavaPhone application. 
Similarly, the TapiEventlnactive advisement is made whenever 
communications with the JavaPhone application (105, 4400) 
are lost. 

PlusTapi Utility Mode (FIG. 13) 

15 The PlusTapi DLL (110, 6600) supports the IWSP utility 

mode in order to provide a means of setting the necessary 
configuration parameters. The FIG. 13 diagram depicts the 
PlusTapi utility mode panel. 

The parameters are defined in the following table: 

20 Table 2: PlusTapi DLL Utility Mode Parameters 



Utility Parameter 


Definition 


PlusTcp conversation number 
for telephony support (1-8) : 


This parameter is used by 
PlusTapi in the "TcpOpen" 
command of the PlusTcp DLL. 
Valid values are 1-8. 


TCP/IP address of telephony 


This is the TCP/IP address 
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support : 


of the JavaPhone 






application. This parameter 






can be set to the string 






LUOulliUO L CIO d W d y UL 






"inHip*pt*"inrr "h h p +* i- h o 






. Tp T7P P n O n r>r~\ 1 -i /-^< —) -)- -! -n -! c 
U d V ct JT L L<J1 1*3 d^JjJX X L^Cl L, ± Ull J_ o 










TCP/IP port number of 


This parameter specifies the 




telephony support : 


numeric port number of the 






TCP/IP socket connection to 






the JavaPhone application. 












VP 1 n p i-hpt" t"hp iTp vp Phnnp 






P V)T) 1 "i ppt i nn ~i o rnnf i nnroH 


*& 




for. 


«*= 

: t : 


Timeout value for 


This parameter controls the 




initialization of telephony 


duration of the PlusTapi 


L = 

WW 
LA 


support (seconds) : 


retry logic that is applied 


= y 




during startup when trying 


01 




tn p^1"phil i <^h p TPP/TP Qrir^V^-h 

L. \J COL.UJJ11011 d X\~fU f -L L OVJOJS."L» 






rnrmprt* i nn wi "h h / p n H 

OUllli^v^ 1 LUil W_LL.11 \ ullU 






inifipl "i 7pt"i nn ofM 1~ h ^ 










Timeout for establishing 


This parameter controls the 




telephony connection 


duration of the PlusTapi 




(seconds ) : 


retry logic to request the 












JavaPhone application and 






the Voice Over Data Gateway 






and the Call Director. 




Timeout for allowing 


This parameter indicates the 




operator to replug headset 


number of seconds that the 
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(seconds) : 


system will allow for the 
operator to replug a headset 
that is removed during an 
active call. If the headset 
is not replugged during the 
specified time, the PlusTapi 
DLL will attempt to transfer 
the call to another 
available operator and then 
logoff the operator. 


TCP/IP Address of Call 
Director Custom Server. 


This is the TCP/IP address 
of the system that is 
running the Call Director 
Custom Server application 


TCP/IP Address of Voice Over 
Data Custom Server. 


This is the TCP/IP address 
of the system that is 
running the Voice Over Data 
Custom Server application 



PlusTapi Diagnostic Support 



PlusTapi includes embedded calls to the existing 
diagnostic support generating the following possible log 
entries : 

1. Traces of the raw data sent to the PlusTcp module 

2. Traces of the raw data received from the PlusTcp module 

3. Any error conditions detected 

4. ASCII entries for each command sent to and response 
received from the JavaPhone application 

5. ASCII entries of any events triggered (Threshold level 
5) 
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Call Status Window (CSW) 

The InfoWin is utilized for defining a display window 
containing the various call status indicators. This window 
is referred to as the "Call Status Window" (CSW) . 

5 FIG. 18 illustrates an exemplary definition of an 

InfoWin (as it might appear in the InfoWin DLL utility) for 
usage as a CSW. With this example, InfoWin Field 1 could be 
used for displaying whether the microphone is muted while 
InfoWin Field2 could indicate whether the call is on hold. 
10 FIG. 19 illustrates what the CSW might look when the InfoWin 
DLL is run in IWSP Normal Mode. 

In this example, InfoWin Field 1 is displaying a "hold" 
indication, InfoWin Field 2 is displaying a "mute" 
indicator. InfoWin Field 3 is displaying whether there is a 
15 "call active", while InfoWin Fields 4-7 display the called 
and calling numbers. Field 13 could be utilized for 
displaying "Not Ready" text. 

All of the displays shown are strictly provided for 
demonstration purposes as the customer would be free to 
20 customize the content and format of the Call Status Window 
using a combination of the following available features: 

1. DISP macro advisement events 

2. PlusTapi macro advisement events 

3. InfoWin DLL Utility 

25 4 . InfoWin SetText command 

5. InfoWin ShowEData command. 
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Method 

The system block diagrams illustrated in FIGs 1-6 may 
be utilized by one skilled in the art in conjunction with 
the data flow diagrams of FIGs. 7-19 to generate appropriate 
5 flowcharts that describe a corresponding method of 
implementing the programmable agent workstation. One 
skilled in the art will recognize that these steps may be 
rearranged and/or augmented with no loss of generality in 
the teachings of the present invention. 

10 The teachings of the present invention are sufficiently 

f^i broad to not limit the manner in which the above-mentioned 

^ steps are to be performed as well as not limiting the method 

si to any particular hardware, operating system, API, or 

^ § graphical user interface. Thus, while the particular 

rfj 15 information gathered within the context of FIG. 1-20 and the 

-- E specific function calls listed in the exemplary flow 

s 

Q diagrams are preferred for some embodiments, they are by no 

l if 5 ! 

means Limitive of the present invention teachings or the" 
fjj scope thereof. 

20 Computer Software 

As would be known by one skilled in the art and as 
indicated in the exemplary embodiments above, the system and 
method described herein and generally illustrated in FIGs. 
1-20 may be reduced to computer instruction codes and 

25 embodied on a computer readable storage means. This may 
take the form of a wide variety of storage media well known 
in the art and/or contemplated for future use. Thus, the 
present invention specifically anticipates the incorporation 
of the system and methods discussed herein in the form of 

30 tangible computer software products. 
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Furthermore, while not limiting the scope of the 
present invention, the present invention specifically 
anticipates that one or more components of the present 
invention may be implemented using the Microsoft® Windows™ 
operating environment and/or the IBM AIX operating 
environment in all their variations or their equivalent 
commercial embodiments, including but not limited to any 
system incorporating a graphical user interface. 

Conclusion 

A programmable, workstation system and method for 
network based call center with telephony functions provided 
over the IP network and using a personal computer is 
disclosed. For such automated call centers there exists a 
need to coordinate the telephony functions with agent 
availability functions. Existing solutions use a switch and 
PSTN phone to communicate information to an automated call 
director (ACD) . The present invention solves the problem of 
doing similar reporting and with coexistence of telephony 
functions along with agent data functions. 

Features of invention include (a) special protocols to 
relay agent information to Virtual ACD and coexist with 
H.323 signaling and (b) the ability to relay agent status 
and provide screen based interface to agent also for such 
information for agent availability and alerting. The system' 
disclosed generally incorporates JavaPhone (105, 4400), 
PlusTcp (109, 5500), and PlusTapi (110, 6600) APIs with 
associated method functions to implement the major functions 
of the invention. 

As illustrated in FIG. 20, while the foregoing 
discussion has been limited to single-call applications, the 
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